From bdb4bf00c59330ff66bf7655252fbd1e15fd6619 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Mon, 6 Jan 2020 20:20:45 -0500 Subject: [PATCH] dragsource: Document prepare --- gtk/gtkdragsource.c | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/gtk/gtkdragsource.c b/gtk/gtkdragsource.c index 022043283f..9975c5bb07 100644 --- a/gtk/gtkdragsource.c +++ b/gtk/gtkdragsource.c @@ -306,6 +306,18 @@ gtk_drag_source_class_init (GtkDragSourceClass *class) g_object_class_install_properties (object_class, NUM_PROPERTIES, properties); + /** + * GtkDragSource::prepare: + * @source: the #GtkDragSource + * @x: the X coordinate of the drag starting point + * @y: the Y coordinate fo the drag starting point + * + * The ::prepare signal is emitted when a drag is about to be initiated. It can + * be used to set up #GtkDragSource:content and #GtkDragSource:actions just in time, + * or to start the drag conditionally. + * + * Returns: %TRUE to start the drag + */ signals[PREPARE] = g_signal_new (I_("prepare"), G_TYPE_FROM_CLASS (class), -- 2.30.2